home *** CD-ROM | disk | FTP | other *** search
/ Cre@te Online 2000 December / Cre@teOnline CD05.iso / MacSoft / XML Authority.sea / XML Authority / Required / Samples / DocBk-Simple / README < prev    next >
Encoding:
Text File  |  2000-05-03  |  3.4 KB  |  106 lines  |  [BINA/hDmp]
  1. README for the Simplified DocBk XML V3.1.4.1 DTD
  2.  
  3. This is a simplified version of the DocBk XML V3.1.3 DTD.  This
  4. DTD is my attempt to make a small subset of DocBook.  I tried to
  5. achieve the following goals:
  6.  
  7.  * Documents written in the subset must be 100% legal DocBk XML
  8.    documents.
  9.  
  10.  * This is for small documents, articles and the like, so
  11.    there's no need for 'book's or 'set's, just 'article's.
  12.  
  13.  * The markup should be the smallest practical subset, if you
  14.    need richly structured markup, use DocBook or DocBk XML.
  15.  
  16.  * The result is roughly "HTML-level markup in DocBook", but I
  17.    didn't set out explicitly to produce that result.
  18.  
  19.  * The DTD must work in IE5 (it's XML not SGML). It should be
  20.    small enough to download more-or-less painlessly.
  21.  
  22.  * There should be a CSS stylesheet for it (mine's pretty lame).
  23.  
  24.  * There should be an XSL stylesheet for it. Since I'm in the
  25.    somewhat privileged position of knowing how many changes are
  26.    coming, I'm going to wait until after the next draft ;-).
  27.  
  28. Instead of DocBook's 350+ elements, this DTD has fewer than 100.
  29.  
  30.  
  31. Manifest
  32. --------
  33.  
  34. README        - This readme file
  35. VERSION       - The version number
  36. COPYRIGHT     - Copyright statement
  37. sdbcent.mod   - Character entities
  38. sdbhier.mod   - Hierarchy overrides
  39. sdbpool.mod   - Information pool overrides
  40. sdocbook-custom.dtd - The DTD
  41. sdocbook.css  - CSS stylesheet
  42. sdocbook.dtd  - A flattened version of the DTD (mechanically generated)
  43. sinclist.mod  - A set of 'ignore' parameter entities
  44. test.xml      - A test document
  45. testcss.xml   - A test document for the CSS stylesheet
  46. testcust.xml  - A test document for the raw customization layer
  47. ent/          - The ISO character entity files used by sdocbook.dtd
  48.  
  49.  
  50. Installation
  51. ------------
  52.  
  53. Place the files in this distribution somewhere on your machine.  Adjust
  54. your catalog(s) if appropriate (XML tools frequently do not support 
  55. catalogs, so this may be irrelevant for you).
  56.  
  57. Please use the following formal public identifier to identify this DTD:
  58.  
  59.   "-//Norman Walsh//DTD Simplified DocBk XML V3.1.4.1//EN"
  60.  
  61. For example, if your document's top-level element is <article>, and
  62. you are using this DTD directly, use the FPI in the DOCTYPE
  63. declaration:
  64.  
  65. <!DOCTYPE article
  66.           PUBLIC "-//Norman Walsh//DTD Simplified DocBk XML V3.1.4.1//EN"
  67.                  "/system/identifier/on/your/system/sdocbook.dtd" [
  68. ...
  69. ]>
  70.  
  71.  
  72. Note: if you are using the customization layer directly (sdocbook-custom.dtd),
  73. you may have to adjust the system identifier that points to the DocBk XML
  74. DTD.  You will also have to install the DocBk XML V3.1.3 DTD somewhere on
  75. your system.
  76.  
  77.  
  78. Copyright
  79. ---------
  80.  
  81. Copyright (C) 1998, 1999 Norman Walsh
  82.  
  83. See COPYRIGHT for more information
  84.  
  85.  
  86. Warranty
  87. --------
  88.  
  89. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  90. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  91. OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  92. NONINFRINGEMENT.  IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
  93. CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  94. WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  95. FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  96. OTHER DEALINGS IN THE SOFTWARE.
  97.  
  98.  
  99. Contacting the Author
  100. ---------------------
  101.  
  102. This DTD is maintained by Norman Walsh, <ndw@nwalsh.com>.
  103.  
  104. The best way to reach norm is by email.  You will find additional
  105. contact information at http://nwalsh.com/docbook/simple/
  106.